home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / gnu / textutils_1_3.LHA / textutils-1.3 / cat / join.1 < prev    next >
Text File  |  1992-09-22  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. JOIN(1L)          MISC. REFERENCE MANUAL PAGES           JOIN(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      join - join lines of two files on a common field
  10.  
  11. SYNOPSIS
  12.      join [-a 1|2] [-v 1|2] [-e empty-string] [-o  field-list...]
  13.      [-t char] [-j[1|2] field] [-1 field] [-2 field] file1 file2
  14.  
  15. DESCRIPTION
  16.      This manual page documents the GNU version  of  join.   join
  17.      prints  to the standard output a line for each pair of input
  18.      lines, one each from _f_i_l_e_1 and _f_i_l_e_2,  that  have  identical
  19.      join  fields.   Either  filename  (but not both) can be `-',
  20.      meaning the standard  input.   _f_i_l_e_1  and  _f_i_l_e_2  should  be
  21.      already  sorted in increasing order (not numerically) on the
  22.      join fields; unless the -_t option is given, they  should  be
  23.      sorted  ignoring  blanks  at  the start of the line, as sort
  24.      does when given the -_b option.
  25.  
  26.      The defaults are: the join field is the first field in  each
  27.      line;  fields  in  the  input  are  separated by one or more
  28.      blanks, with leading blanks on the line ignored;  fields  in
  29.      the  output  are separated by a space; each output line con-
  30.      sists of the join field, the remaining  fields  from  _f_i_l_e_1,
  31.      then the remaining fields from _f_i_l_e_2.
  32.  
  33.   OPTIONS
  34.      -_a _f_i_l_e-_n_u_m_b_e_r
  35.           Print a line for each unpairable  line  in  file  _f_i_l_e-
  36.           _n_u_m_b_e_r  (either 1 or 2), in addition to the normal out-
  37.           put.
  38.  
  39.      -_e _s_t_r_i_n_g
  40.           Replace empty output fields (those that are missing  in
  41.           the input) with _s_t_r_i_n_g.
  42.  
  43.      -_1, -_j_1 _f_i_e_l_d
  44.           Join on field _f_i_e_l_d (a positive integer) of file 1.
  45.  
  46.      -_2, -_j_2 _f_i_e_l_d
  47.           Join on field _f_i_e_l_d (a positive integer) of file 2.
  48.  
  49.      -_j _f_i_e_l_d
  50.           Equivalent to -_1 _f_i_e_l_d -_2 _f_i_e_l_d.
  51.  
  52.      -_o _f_i_e_l_d-_l_i_s_t...
  53.           Construct each output line according to the  format  in
  54.           _f_i_e_l_d-_l_i_s_t.   Each  element in _f_i_e_l_d-_l_i_s_t consists of a
  55.           file number (either 1 or 2),  a  period,  and  a  field
  56.           number  (a positive integer).  The elements in the list
  57.           are separated by commas or blanks.  Multiple _f_i_e_l_d-_l_i_s_t
  58.           arguments  can  be  given after a single -_o option; the
  59.           values of all lists  given  with  -_o  are  concatenated
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JOIN(1L)          MISC. REFERENCE MANUAL PAGES           JOIN(1L)
  71.  
  72.  
  73.  
  74.           together.
  75.  
  76.      -_t _c_h_a_r
  77.           Use character  _c_h_a_r  as  the  input  and  output  field
  78.           separator.
  79.  
  80.      -_v _f_i_l_e-_n_u_m_b_e_r
  81.           Print a line for each unpairable  line  in  file  _f_i_l_e-
  82.           _n_u_m_b_e_r (either 1 or 2), instead of the normal output.
  83.  
  84.      The long-named options can be introduced with `+' as well as
  85.      `--',  for compatibility with previous releases.  Eventually
  86.      support for `+' will be removed, because it is  incompatible
  87.      with the POSIX.2 standard.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.